跳到主要内容
版本:1.0.13

ALTER EXTENSION

ALTER EXTENSION — 更改一个扩展的定义


大纲:

ALTER EXTENSION name UPDATE [ TO new_version ]

ALTER EXTENSION name SET SCHEMA new_schema

ALTER EXTENSION name ADD member_object

ALTER EXTENSION name DROP member_object

其中 member_object 是:

ACCESS METHOD object_name |

AGGREGATE aggregate_name ( aggregate_signature ) |

CAST (source_type AS target_type) |

COLLATION object_name |

CONVERSION object_name |

DOMAIN object_name |

EVENT TRIGGER object_name |

FOREIGN DATA WRAPPER object_name |

FOREIGN TABLE object_name |

FUNCTION function_name [ ( [ [ argmode ] [ argname ] argtype [, ...] ] ) ] |

MATERIALIZED VIEW object_name |

OPERATOR operator_name (left_type, right_type) |

OPERATOR CLASS object_name USING index_method |

OPERATOR FAMILY object_name USING index_method |

[ PROCEDURAL ] LANGUAGE object_name |

PROCEDURE procedure_name [ ( [ [ argmode ] [ argname ] argtype [, ...] ] ) ] |

ROUTINE routine_name [ ( [ [ argmode ] [ argname ] argtype [, ...] ] ) ] |

SCHEMA object_name |

SEQUENCE object_name |

SERVER object_name |

TABLE object_name |

TEXT SEARCH CONFIGURATION object_name |

TEXT SEARCH DICTIONARY object_name |

TEXT SEARCH PARSER object_name |

TEXT SEARCH TEMPLATE object_name |

TRANSFORM FOR type_name LANGUAGE lang_name |

TYPE object_name |

VIEW object_name

并且 aggregate_signature 是:

* |

[ argmode ] [ argname ] argtype [ , ... ] |

[ [ argmode ] [ argname ] argtype [ , ... ] ] ORDER BY [ argmode ] [ argname

] argtype [ , ... ]


描述:

ALTER EXTENSION更改一个已安装扩展的定义。 有几种子形式:

UPDATE

这种形式把该扩展更新到一个新版本。该扩展必须提供一个适当的更新 脚本(或者一系列脚本)来把当前已安装的版本修改成所要求的版本。

SET SCHEMA

这种形式把该扩展的对象移动到另一个模式中。要使这个命令成功,该扩展必须是可重定位的。

ADD member_object

这种形式把一个现有的对象加入到该扩展中。这主要对扩展更新脚本有用。该对象后续将被当作该扩展的一个成员。尤其是该对象只有通过删除扩展才能删除。

DROP member_object

这种形式从该扩展移除一个成员对象。这主要对扩展更新脚本有用。只有 撤销该对象与其扩展之间的关联后才能删除该对象。

要使用ALTER EXTENSION,你必须拥有该扩展。 ADD/DROP形式还要求被增加/删除对象的所有权。


参数:

name

一个已安装扩展的名称。

new_version

想要得到的该扩展的新版本。这可以写成一个标识符或者一个字符串。如果没有指定,ALTER EXTENSION UPDATE会尝试更新到该扩展的控制文件中的默认版本。

new_schema

该扩展的新模式。

object_name

aggregate_name

function_name

operator_name

procedure_name

routine_name

要从该扩展增加或者移除的对象的名称。表、聚集、域、外部表、函数、操作符、操作符类、操作符族、过程、例程、序列、文本搜索对象、类型和视图的名称可以被模式限定。

source_type

该转换的源数据类型的名称。

target_type

该转换的目标数据类型的名称。

argmode

一个函数、过程或者聚集参数的模式:IN、OUT、 INOUT或者VARIADIC。如果被忽略,默认值是 IN。注意,ALTER EXTENSION 并不真正关心OUT参数,因为决定该函数的身份时,只需要输入参数。因此列出IN、INOUT和 VARIADIC参数足矣。

argname

一个函数、过程或者聚集参数的名称。注意,ALTER EXTENSION并不真正关心参数名称,因为 决定该函数的身份时只需要参数的数据类型。

argtype

一个函数、过程或者或聚集参数的数据类型。

left_type

right_type

该操作符参数的数据类型(可以用模式限定)。对一个前缀或后缀操作符的缺失的 参数可以写NONE。

PROCEDURAL

这是一个噪声词。

type_name

该转换的数据类型的名称。

lang_name

该转换的语言的名称。


示例:

把hstore扩展更新到版本 2.0:

ALTER EXTENSION hstore UPDATE TO '2.0';

把hstore扩展的模式更改到utils:

ALTER EXTENSION hstore SET SCHEMA utils;

要向hstore扩展增加一个现有函数:

ALTER EXTENSION hstore ADD FUNCTION populate_record(anyelement, hstore);


另见:

CREATE EXTENSION, DROP EXTENSION